************************************************************ ************************************************************ * * Intel(R) Brookdale-G IBM* OS/2* GRADD Display Driver * Installation Notes * * Date: March 15th, 2002 * Revision: OS/2 GRADD Display Driver Release 0219 Build 0001 * Production Version * * NOTE: This document refers to systems containing the * following Intel chipsets: * Intel(R) Brookdale-G * * This document makes references to unannounced products * being developed by Intel. There are some restrictions * on how these products may be used and what information * may be disclosed to others. Please read the Disclaimer * section at the bottom of this document and contact your * Intel field representative if you would like more * information. * ************************************************************ ************************************************************ ************************************************************ * CONTENTS OF THIS DOCUMENT ************************************************************ This document contains the following sections: 1. Contents of the Distribution Package 2. System Requirements 3. Installing the Software 4. Verifying Installation of the Software 5. Troubleshooting 6. De-installing the Software 7. Identifying the Software Version Number ************************************************************ * 1. CONTENTS OF THE DISTRIBUTION PACKAGE ************************************************************ The Intel(R) Chipset GRADD display driver provides accelerated display graphics for PM and Win OS2 applications at SVGA color depths and resolutions. It also provides monitor selection and refresh configuration capability. The Intel(R) chipset GRADD display driver includes system Components required for GRADD operation, as released by IBM on 08/27/1999 as "BBS Video Build Level 0.080". The installation will not replace GRADD system components from a more recent build, as checked by the date of the top component \os2\dll\gre2vman.dll. ************************************************************ * 2. SYSTEM REQUIREMENTS ************************************************************ 1. The system must contain one of the following Intel chipsets: Intel(R) Brookdale-G Chipset 2. The following operating system must be installed on the system: IBM OS/2 Warp v4 with fixpack 5 or later IBM OS/2 Warp v4 for Taiwan with fixpack 5 and later IBM OS/2 Warp v4 for Thailand with fixpack 5 and later IBM OS/2 Warp v4 for Japan with fixpack 5 and later IBM OS/2 Warp v3 with fixpak 35 or later IBM OS/2 Warp v4 for Japan with fixpack 5 or later IBM OS/2 Warp v3 for Japan with fixpak 35 or later 3. This software has been designed solely for use with IBM OS/2 Warp v4.0 English with fixpack 5 and later IBM OS/2 Warp v4.0 for Taiwan with fixpack 5 and later IBM OS/2 Warp v4.0 for Thailand with fixpack 5 and later IBM OS/2 Warp v4.0 for Japan with fixpack 5 and later IBM OS/2 Warp v3.0 English with fixpak 35 or later IBM OS/2 Warp v3.0 for Japan with fixpak 35 or later 4. The system must be setup in VGA mode. For instructions, refer to the "De-Installing the Software" section. To determine the level of IBM OS/2 running, execute SYSLEVEL command from any IBM OS/2 command prompt. ************************************************************ * 3. INSTALLING AND EXECUTING THE SOFTWARE ************************************************************ INSTALLATION FROM DISKETTE ^^^^^^^^^^^^^^^^^^^^^^^^^^ 1. Check the system requirements. IBM OS/2 must be fully installed and running on the system prior to running this software. The system must be in VGA mode. If installing additional fixpacks, do so while the system is in VGA mode. For instructions on setting the desktop in VGA mode, refer to the "De-Installing the Software" section. All IBM OS/2 sessions must be closed prior to installing this driver. 2. Insert the Intel GRADD driver diskette into drive A (or any other diskette drive). 3. Open an IBM OS/2 full-screen or IBM OS/2 window session. IBM OS/2 version 4 only: ^^^^^^^^^^^^^^^^^^^^^^^ At the IBM OS/2 command prompt, change to drive A:. Type the following command to copy all necessary files to the IBM OS/2 drive: [a:]SETUP [/u] is the diskette drive. is the drive where IBM OS/2 is installed. [/u] is optional and is used to indicate unattended install such as for CID installations. A CID response file is not required. IBM OS/2 version 3 only: ^^^^^^^^^^^^^^^^^^^^^^^ Requires the setup to be executed from the partition containing the OS. In IBM OS/2 version 3, copy all files from the floppy disk to the hard drive. At the IBM OS/2 version command prompt, type the following command to copy all necessary files to the IBM OS/2 drive: [c:]SETUP [/u] is the diskette drive. is the drive where IBM OS/2 is installed. [/u] is optional and is used to indicate unattended install such as for CID installations. A CID response file is not required. Then press Enter. A number of system files will be transferred if the ones found on the system are older. When a popup asking for Monitor configuration choice pops up, accept "Use monitor defaults" choice. The installation will then blank the screen while testing VESA modes and if successful, it will transfer driver files. 4. When prompted to do so, remove the diskette from drive A, perform a shutdown, and then restart your computer. 5. When the system reboots, do the following: a. Open the IBM OS/2 System folder. b. Open the System Setup folder. c. Open the System object. d. When the Settings notebook appears, select the Screen tab. e. Select a resolution from the page 1. f. Select a monitor from page 2. g. Select refresh setting from the page 1 of the Screen tab. h. Close the Settings notebook. i. The selected resolution will be in effect upon the next boot. INSTALLATION IN A CID ENVIRONMENT ^^^^^^^^^^^^^^^^^^^*^^^^^^^^^^^^^ 1. Create a directory on the server (i.e. GRADDS). Copy the files from the Intel(R) GRADD driver diskette to the GRADDS directory. 2. IBM OS/2 must have been successfully installed on the client using the CID (Configuration Installation Distribution) method. To install a GRADD driver using CID, use the following information to modify your LCU command file. NOTE: The following information is meant as a guide. Your LCU command file might be different. /*****************************************************/ /* LCU PRODUCT DATA SECTION */ /*****************************************************/ . . . x.graddvideo = 15 x.15.name='Intel Gradd Video' x.15.statevar = 'CAS_' || x.15.name x.15.instprog = 'x:\img\gradds\SETUP.CMD', ' x:\img\gradds ' || bootdrive, ' /u' x.15.rspdir = '' x.15.default = '' /*---------------------------------------------------*/ /* NUMBER OF PROGRAMS SET UP IN THE */ /* PRODUCT DATA SECTION */ /*---------------------------------------------------*/ NUM_INSTALL_PROGS = 15 /*****************************************************/ /* INSTALLATION SECTION */ /*****************************************************/ . . . when OVERALL_STATE = 2 then do if RunInstall(x.graddvideo) == BAD_RC then exit Call CheckBoot end . . . /******************************************************/ /* ROUTINE SECTION */ /* The following information should already exist in */ /* the LCU command file. */ /******************************************************/ . . . RebootAndGotoState: parse arg new_state, other /* Set the state to go in OVERALL_STATE */ rc2 = SetState(new_state, 'RebootAndGotoState', 1) /* Save the environment vars */ Call SaveStates /* Reboot the machine */ Call Reboot return . . . /*****************************************************/ END OF LCU INFORMATION TO BE ADDED /*****************************************************/ You may refer to readme.cfg on this diskette for information on how to setup monitor, resolution and refresh during CID install. ************************************************************ * 4. VERIFYING INSTALLATION OF THE SOFTWARE ************************************************************ 1. Open the IBM OS/2 System folder. 2. Open the System Setup folder. 3. Open the System object. 4. When the Settings notebook appears, select the Screen tab. 5. Select Configuration from the page 2. The window will contain the Intel(R) 815 keyword. ************************************************************ * 5. TROUBLESHOOTING ************************************************************ This section provides troubleshooting information. Installation problems --------------------- 1. During the installation of this driver, DISPLAY.LOG and DSPINSTL.LOG files are created in the OS2\INSTALL directory. These files identify the IBM OS/2 system files that were updated and indicate whether the installation was successful. The contents of these files might be useful if you need to report an installation problem to Intel. 2. Installation of the GRADD uses the Dspinstl utility shipped with IBM OS/2 4.0. This utility can fail if it finds a *.dsc file which is not a dspinstl description file. During testing, it was found that installation of SystemView for IBM OS/2 client may leave behind a file called "commonag.dsc" on the root of the bootdrive. This file is not a Dspinstl description file and will cause Dspinstl to fail. If you have this problem, simply rename or delete the problem file. If an incorrect description file is encountered, it will be noted in the above log(s). How to determine if the OS/2 GRADD Display Driver is loaded ----------------------------------------------------------- Refer to section 4: Verifying installation of the software. Refer to section 7: Identifying the software version number. ************************************************************ * 6. DE-INSTALLING THE SOFTWARE ************************************************************ Use the following procedures to return to VGA mode and deinstall the software: 1. Turn on your computer. If your computer is already on, press Ctrl+Alt+Del to restart it. 2. When a small white box appears in the upper left-hand corner of your screen, press Alt+F1. 3. When the Recovery Choices screen appears, press function key F3. 4. Your desktop will now boot in VGA mode. This de-installation procedure is specific only to the version of the driver and installation file included in this package. ************************************************************ * 7. IDENTIFYING THE SOFTWARE VERSION NUMBER ************************************************************ You may execute bldlevel command as follows: cd \os2\dll bldlevel intgradd.dll The Vendor string should read "INT", and the Revision string should be the same as revision value of this readme. The vendor and revision strings can also be found in the build.lvl file on the installation diskette. ************************************************************ * INTEL SOFTWARE LICENSE AGREEMENT * (OEM/IHV Distribution & Single User) ************************************************************ IMPORTANT - READ BEFORE COPYING, INSTALLING OR USING. Do not use or load this software and any associated materials (collectively, the "Software") until you have carefully read the following terms and conditions. By loading or using the Software, you agree to the terms of this Agreement. If you do not wish to so agree, do not install or use the Software. Please Also Note: * If you are an Original Equipment Manufacturer (OEM) or Independent Hardware Vendor (IHV), this complete LICENSE AGREEMENT applies; * If you are an End-User, then only Exhibit A, the INTEL SOFTWARE LICENSE AGREEMENT, applies. --------------------------------------------------------- For OEMs and IHVs: LICENSE. Subject to the terms of this Agreement, Intel grants to You a nonexclusive, nontransferable, worldwide, fully paid-up license under Intel's copyrights to: a) use and copy Software internally for Your own development and maintenance purposes; and b) copy and distribute Software, including derivative works of the Software, to Your end-users, but only under a license agreement with terms at least as restrictive as those contained in Intel's Final, Single-User License Agreement, attached as Exhibit A; and c) modify, copy and distribute the end-user documentation that may accompany the Software, but only in association with the Software. If You are not the final manufacturer or vendor of a computer system or software program incorporating the Software, then You may transfer a copy of the Software, including derivative works of the Software (and related end-user documentation), to Your recipient for use in accordance with the terms of this Agreement, provided such recipient agrees to be fully bound by the terms hereof. You shall not otherwise assign, sublicense, lease or in any other way transfer or disclose Software to any third party. You shall not reverse-compile, disassemble or otherwise reverse-engineer the Software. Except as expressly stated in this Agreement, no license or right is granted to You directly or by implication, inducement, estoppel or otherwise. Intel shall have the right to inspect or have an independent auditor inspect Your relevant records to verify Your compliance with the terms and conditions of this Agreement. CONFIDENTIALITY. If You wish to have a third-party consultant or subcontractor ("Contractor") perform work on Your behalf that involves access to or use of Software, You shall obtain a written confidentiality agreement from the Contractor that contains terms and obligations with respect to access to or use of Software no less restrictive than those set forth in this Agreement and excluding any distribution rights, and use for any other purpose. Otherwise, You shall not disclose the terms or existence of this Agreement or use Intel's name in any publications, advertisements or other announcements without Intel's prior written consent. You do not have any rights to use any Intel trademarks or logos. OWNERSHIP OF SOFTWARE AND COPYRIGHTS. Title to all copies of the Software remains with Intel or its suppliers. The Software is copyrighted and protected by the laws of the United States and other countries, and by international treaty provisions. You may not remove any copyright notices from the Software. Intel may make changes to the Software, or to items referenced therein, at any time without notice, but is not obligated to support or update the Software. Except as otherwise expressly provided, Intel grants no express or implied right under Intel patents, copyrights, trademarks or other intellectual property rights. You may transfer the Software only if the recipient agrees to be fully bound by these terms and if you retain no copies of the Software. LIMITED MEDIA WARRANTY. If the Software has been delivered by Intel on physical media, Intel warrants the media to be free from material, physical defects for a period of ninety days after delivery by Intel. If such a defect is found, return the media to Intel for replacement or alternate delivery of the Software as Intel may select. EXCLUSION OF OTHER WARRANTIES. EXCEPT AS PROVIDED ABOVE, THE SOFTWARE IS PROVIDED "AS IS," WITHOUT ANY EXPRESS OR IMPLIED WARRANTY OF ANY KIND, INCLUDING WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT OR FITNESS FOR A PARTICULAR PURPOSE. Intel does not warrant or assume responsibility for the accuracy or completeness of any information, text, graphics, links or other items contained within the Software. LIMITATION OF LIABILITY. IN NO EVENT SHALL INTEL OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION OR LOST INFORMATION) RESULTING FROM THE USE OF OR INABILITY TO USE THE SOFTWARE, EVEN IF INTEL HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME JURISDICTIONS PROHIBIT EXCLUSION OR LIMITATION OF LIABILITY FOR IMPLIED WARRANTIES OR CONSEQUENTIAL OR INCIDENTAL DAMAGES, SO THE ABOVE LIMITATION MAY NOT APPLY TO YOU. YOU MAY ALSO HAVE OTHER LEGAL RIGHTS THAT VARY FROM JURISDICTION TO JURISDICTION. TERMINATION OF THIS AGREEMENT. Intel may terminate this Agreement at any time if you violate its terms. Upon termination, you will immediately destroy the Software or return all copies of the Software to Intel. APPLICABLE LAWS. Claims arising under this Agreement shall be governed by the laws of California, excluding its principles of conflict of laws and the United Nations Convention on Contracts for the Sale of Goods. You may not export the Software in violation of applicable export laws and regulations. Intel is not obligated under any other agreements unless they are in writing and signed by an authorized representative of Intel. GOVERNMENT RESTRICTED RIGHTS. The Software is provided with "RESTRICTED RIGHTS." Use, duplication or disclosure by the Government is subject to restrictions as set forth in FAR52.227-14 and DFAR252.227-7013 et seq. or its successor. Use of the Software by the Government constitutes acknowledgment of Intel's proprietary rights therein. Contractor or Manufacturer is Intel Corporation, 2200 Mission College Blvd., Santa Clara, CA 95052. --------------------------------------------------------- EXHIBIT "A" INTEL SOFTWARE LICENSE AGREEMENT (Final, Single User) IMPORTANT - READ BEFORE COPYING, INSTALLING OR USING. Do not use or load this software and any associated materials (collectively, the "Software") until you have carefully read the following terms and conditions. By loading or using the Software, you agree to the terms of this Agreement. If you do not wish to so agree, do not install or use the Software. LICENSE. You may copy the Software onto a single computer for your personal, non-commercial use, and you may make one back-up copy of the Software, subject to these conditions: 1. You may not copy, modify, rent, sell, distribute or transfer any part of the Software except as provided in this Agreement, and you agree to prevent unauthorized copying of the Software. 2. You may not reverse-engineer, decompile or disassemble the Software. 3. You may not sublicense or permit simultaneous use of the Software by more than one user. 4. The Software may contain the software or other property of third-party suppliers, some of which may be identified in, and licensed in accordance with, any enclosed "license.txt" file or other text or file. OWNERSHIP OF SOFTWARE AND COPYRIGHTS. Title to all copies of the Software remains with Intel or its suppliers. The Software is copyrighted and protected by the laws of the United States and other countries, and international treaty provisions. You may not remove any copyright notices from the Software. Intel may make changes to the Software, or to items referenced therein, at any time without notice, but is not obligated to support or update the Software. Except as otherwise expressly provided, Intel grants no express or implied right under Intel patents, copyrights, trademarks or other intellectual property rights. You may transfer the Software only if the recipient agrees to be fully bound by these terms and if you retain no copies of the Software. LIMITED MEDIA WARRANTY. If the Software has been delivered by Intel on physical media, Intel warrants the media to be free from material, physical defects for a period of ninety days after delivery by Intel. If such a defect is found, return the media to Intel for replacement or alternate delivery of the Software as Intel may select. EXCLUSION OF OTHER WARRANTIES. EXCEPT AS PROVIDED ABOVE, THE SOFTWARE IS PROVIDED "AS IS," WITHOUT ANY EXPRESS OR IMPLIED WARRANTY OF ANY KIND, INCLUDING WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT OR FITNESS FOR A PARTICULAR PURPOSE. Intel does not warrant or assume responsibility for the accuracy or completeness of any information, text, graphics, links or other items contained within the Software. LIMITATION OF LIABILITY. IN NO EVENT SHALL INTEL OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION OR LOST INFORMATION) RESULTING FROM THE USE OF OR INABILITY TO USE THE SOFTWARE, EVEN IF INTEL HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME JURISDICTIONS PROHIBIT EXCLUSION OR LIMITATION OF LIABILITY FOR IMPLIED WARRANTIES OR CONSEQUENTIAL OR INCIDENTAL DAMAGES, SO THE ABOVE LIMITATION MAY NOT APPLY TO YOU. YOU MAY ALSO HAVE OTHER LEGAL RIGHTS THAT VARY FROM JURISDICTION TO JURISDICTION. TERMINATION OF THIS AGREEMENT. Intel may terminate this Agreement at any time if you violate its terms. Upon termination, you will immediately destroy the Software or return all copies of the Software to Intel. APPLICABLE LAWS. Claims arising under this Agreement shall be governed by the laws of California, excluding its principles of conflict of laws and the United Nations Convention on Contracts for the Sale of Goods. You may not export the Software in violation of applicable export laws and regulations. Intel is not obligated under any other agreements unless they are in writing and signed by an authorized representative of Intel. GOVERNMENT RESTRICTED RIGHTS. The Software is provided with "RESTRICTED RIGHTS." Use, duplication or disclosure by the Government is subject to restrictions as set forth in FAR52.227-14 and DFAR252.227-7013 et seq. or its successor. Use of the Software by the Government constitutes acknowledgment of Intel's proprietary rights therein. Contractor or Manufacturer is Intel Corporation, 2200 Mission College Blvd., Santa Clara, CA 95052. SLAOEMIHV/RBK/November 4, 1998 ************************************************************ ************************************************************ * DISCLAIMER ************************************************************ Intel is making no claims of usability, efficacy or warranty. The INTEL SOFTWARE LICENSE AGREEMENT contained herein completely defines the license and use of this software. ************************************************************ Information in this document is provided in connection with Intel products. Except as expressly stated in the INTEL SOFTWARE LICENSE AGREEMENT contained herein, no license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document. Except as provided in Intel's Terms and Conditions of Sale for such products, Intel assumes no liability whatsoever, and Intel disclaims any express or implied warranty, relating to sale and/or use of Intel products, including liability or warranties relating to fitness for a particular purpose, merchantability or infringement of any patent, copyright or other intellectual property right. Intel products are not intended for use in medical, lifesaving, or life-sustaining applications. ************************************************************ * Intel Corporation disclaims all warranties and liabilities * for the use of this document, the software and the * information contained herein, and assumes no * responsibility for any errors which may appear in this * document or the software, nor does Intel make a commitment * to update the information or software contained herein. * Intel reserves the right to make changes to this document * or software at any time, without notice. ************************************************************ * Third-party brands and names are the property of their respective owners. Copyright (c) 1998-2000, Intel Corporation. All rights reserved.